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Dear Reader, 

It has come to our attention that a bug appears in our book, TRACER: AN AID TO 6800 PROGRAM 
DEBUGGING. 

As written, the Change SP function only changes the data stored at $0070. When you Continue Trace, 
that data is thrown away and is replaced by the current Stack Pointer address, so nothing is changed. By 
making the following modification to the Tracer program, everything works as intended and stack reference 
data is retained in the new stack location to a level of 16 bytes: 

* CHANGE TO 


020B 

7E 

030B 

R 

* ADD 

JMP SCONT 

continue change stack pointer 

030B 

FF 

0070 

R 

SCONT 

STX STACKP 

store it 

030E 

09 




DEX 


030F 

09 




DEX 


0310 

5F 




CLRB 

zero counter 

0311 

08 



OVR 

INX 

line up new & old stacks 

0312 

32 




PULA 

data from old stack 

0313 

A7 

00 



STAA 0,X 

store it in new stack 

0315 

5C 




INC8 

count 

0316 

Cl 

10 



CMPB $10 

done transfer data ? 

0318 

26 

F7 



BNE OVR 


031A 

BE 

0070 

R 


LDS 

get new real stack 

031D 

34 




DES 

adjust it for new psuedo stack 

031E 

34 




DES 


031F 

7E 

020E 

R 


JMP $020E 

END 

back to original "S" 


We apologize for any inconvenience this may have caused you. 

Sincerely, 


Blaise W. Liffick 
Senior Editor 






This short story provides a humorous but tutorial account of the origins of the Tracer pro¬ 
gram in Jack Hemenway’s homebrew 6800 system. It is reprinted here from the December 1977 
issue of BYTE, where it first appeared. 


Jack and the Machine Debug 


“It has to be done by now. That sub¬ 
routine canT take much more than a few 
milliseconds per entry, and there aren’t 
many entries. I’ll give it a few more 
seconds.” Jack sat nervously puffing his 
cigar. “It can’t take this long,” said jack, his 
patience exhausted. He punched the RESET 
button. 

“What do you want now. Jack? Here 1 
am, faithfully running your program, and 
you interrupt me. Find a mistake in your 
code?” 

“Hardly. You should be done by now. 
What have you been doing that took so 
long?” 

“Well, when you interrupted me, I think 
I was executing a load-immediate 
instruction.” 

“Where?” 

“How should I know? You interrupted 
me. I’m in the monitor ROM now. I can’t 
keep track of every instruction I execute.” 

“True, true. It sure would be nice if you 
could, though.” 

“Well, I can’t. I already assemble your 
programs for you; you can’t expect me to 
debug them for you too! That’s supposed to 
be your department!” 

“I know, computer. How do I figure 
out where you went wrong?” 

“How do I know?” 

“Calm yourself or I’ll use your parts in 
my F8.” 

“Okay, Jack. I’m sorry I lost my head. 
Anything would be better than inflicting 
that F8 on us. How about trying a break¬ 
point?” 

“Good idea! Computer, sometimes you 
amaze me. Try a breakpoint at the sub¬ 
routine return.” 


“Shouldn’t I reload the program first, 
Jack?” 

“I guess so.” Jack waited as computer 
reloaded the program from its cassettes. 
“Now, put a software interrupt at 1 ECO.” 

“One SWl inserted (hexadecimal 3F to 
me). Shall I run the program now?” 

“Start.” Jack went into the kitchen for 
a beer. He returned a few minutes later. 
“Computer! What are you doing? RESET!” 

“Now what?” 

“I told you to set a breakpoint!” 

“I did set a breakpoint; see the 3F at 
1 FCO. 1 just haven’t executed that instruc¬ 
tion yet.” 

“Why not?” 

“I haven’t the foggiest idea. I just execute 
them in the order that you wrote them. 
Writing programs is supposed to be your 
contribution to our work.” 

“Don’t get snide. Remove the break¬ 
point.” 

“Done.” 

“Now, put the breakpoint at 1 FA2.” 

“I’ll reload the program first. Jack.” 

“I guess you should, but I hate waiting 
for those cassettes.” 

“They’re your design, remember. If you 
want speed, buy me some disks.” 

“They’re on order.” 

“Great. Now let me load the program the 
best I can from these archaic, cranky, slow, 
old . . .” 

“Just do the job without the com¬ 
mentary!” 

The cassette in the read drive turned ever 
so slowly. “I’m ready now, Jack. The break¬ 
point is set.” 

“Start the program.” 

Time passed, a lot of time. Jack stabbed 
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the RESET button hard enough to push 
the computer across the desk. 

“Gently, jack! I get your message. You 
must be putting the breakpoint in the wrong 
place.” 

“If 1 knew where to put the breakpoint, 
then 1 probably wouldn’t need one. What 1 
need is some way to sprinkle a program with 
breakpoints and just skip the ones I don’t 
need.” 

“No can do, jack. My MIKBUG monitor 
traps every breakpoint and that is that. You 
can’t skip by one. If you put obstacles in 
my path, I trip over them. You don’t want 
a bruised computer, do you, jack?” 

“I guess not. What I do want is a better 
way to debug. There’s got to be something 
more effective than this ‘stab in the dark’ 
approach.” 

“May 1 make a suggestion, jack?” 

“Now look who’s the designer. What 
words of wisdom have you, O great sage of 
Motorola?” 

“Sarcasm will get you nowhere, except 
maybe ‘stabbed in the dark.’ I was going to 
suggest that you investigate my HALT in¬ 
put. If you put a properly timed signal there, 
then I’ll execute only one instruction at a 
time. You can run programs so slowly even 
a human can follow the processing.” 

“That’s an interesting idea. Let me think 
about it for a while.” 

“1 can hardly stop you, jack. 1 don’t have 
hands. . .yet. You were looking at those 
robot articles in BYTE, weren’t you!” 

“Talking is quite enough, computer!” 

“I. . .guess. . .so.” 

jack sat back in his chair and thought. 
Computer knew better than to interrupt 
such meditations of his human partner. 
Computer liked its power continuous. 

“No good, computer.” jack rolled his 
chair to the console again. “Hardware single 
stepping isn’t what I need. I need to be able 
to read your registers and check memory 
locations. In short, 1 need your MIKBUG 
capabilities to help me debug. With your 
hardware suggestion I’d still need to know 
where to stop single stepping. That’s no 
better than breakpointing.” 

“Not exactly, jack. If you don’t muck up 
my contents with your debugging stuff, 
then you can resume running again after 
you stop stepping. You can write reentrant 
code, can’t you, jack?” 


“That's exactly what I’m trying to debug. 
Thanks a bunch.” 

“Sorry, I guess we’ll both have to live 
with MIKBUG for a while longer, until you 
write me a real nice monitor, with asynchro¬ 
nous 10, and disks, and. , .” 

“Get off the disk kick. A debugger is 
what I need. I want a purely software 
answer. I need to have MIKBUG-like facili¬ 
ties that I can use wherever 1 want in a pro¬ 
gram without upsetting that program. It’s 
got to be reentrant. It’s got to know how to 
break down instructions. It should give me 
a sort of breakpoint for each instruction 
executed.” 

“The program you seek is called a tracer. 
They’re available on big machines, like your 
partner Grappel’s PDP-11. Maybe he can 
adapt one to your liking.” 

“And adapt it to your limited faculties.” 

“His big machine can’t even talk! Don’t 
you say I’m limited!” 

“Okay, okay, 1 give up. Anyway, it’s 
bedtime. Good night.” 

“Yeah,” said computer, jack flipped the 
power switch, and computer’s red eye 
dimmed. 

“So what’s new?” said computer as its 
fan began to hum. 

“Well, I uh. . .found. . .discovered that 
.. .noticed, uh. . .” 

“Come on. Jack, out with it!” 

“That problem you were having 
yesterday...” 

“1 wasn’t having any problem yesterday! 
It was your code that was a problem. 1 just 
read ’em; I don’t write ’em!” 

“1 know. But you should have warned 
me that I was pushing one more item onto 
the stack than I was popping off. When you 
executed the subroutine return, you got a 
byte of data confused with the real return 
address.” 

“I did not confuse anything! I did exact¬ 
ly, I repeat, exactly, what you asked for. 
You said PSH, I pushed! You said PUL, I 
pulled a byte off the stack. You said RTS, 
and I took the top of the stack as a return 
address. I may have bugs in the program, but 
the programmer’s got bats in his belfry! 
If you can’t count the number of bytes you 
put on the stack, you might think of going 
back to philosophy!” 


6 



“Cool it!“ 

“I might say.. 

“Cool it!“ 

Jack glared at the console, and com¬ 
puter’s red eye stared back. “I’m sorry, 
jack.’’ 

“I guess it really is my fault, computer.’’ 

“Friends?” 

“Friends.” 

“Going to get a tracer written?” 

“Yep.” 

“Can I assemble it? I’ll do a very careful 
job.” 

“I’m sure you will, computer. I’m sure 
you will.” 

“Computer, let’s try to work this break¬ 
point thing out.” 

“Glad to help, jack.” 

“Fine. Now, we need a program which 
doesn’t change any register or condition 
code or memory location in the target 
program. . .the one I need to debug.” 

“It’s got to be reentrant. Right, jack?” 

“It should print the contents of all your 
registers, the address of the present instruc¬ 
tion, and the instruction code. Something 
like the MIKBUG format should do.” 

“That’s a problem. How do I do all that 
printing without messing up the registers?” 

“Come on, computer. . .that’s easy. You 
save all the registers before printing and then 
restore them when you’re done.” 

“Like the MIKBUG software interrupt 
does, on the stack! You know, sometimes 
you’re pretty smart, jack.” 

“Except we can’t do it that way.” 

“Why?” 

“Because MIKBUG won’t let me change 
the address of the software interrupt handler 
program. It’s in ROM, unfortunately. We’ll 
need another way.” 

“jack, isn’t this breakpoint thing sort of 
like a subroutine? I mean, it’s, say, ‘called’ 
from the target program.. .does some stuff 
like printing. . .and then returns to the 
target program.” 

“I guess we have to do it that way. We’ll 
put a subroutine call (jSR) at the address 
where the trace is to begin. It will call the 
trace program, which will be written as a 
subroutine. The subroutine will first have to 
save all the registers, then print my debug¬ 
ging info. It can then restore the registers 


and return. Thanks for the idea, computer.” 

“Don’t thank me yet; it won’t work. If 
I insert a 3 byte subroutine jump into the 
target program, then I’ve destroyed three 
bytes of your code. Then, when I return 
from the subroutine, I return three bytes 
further into the target program, not where I 
started.” 

jack thought a bit and puffed his cigar. 

“jack! That cigar smoke is getting in my 
cassettes! How can you humans stand all 
that stuff? Do computers get cancer of the 
integrated circuit or something?” 

“Relax, my automated friend. You’re 
quite safe. I just figured out how to work 
the tracing.” 

“I’m all ears.” 

“I’m surprised you can stop talking long 
enough to listen. Anyway, I can overcome 
your objections by careful programming. 
Before inserting the subroutine jump, you’ll 
save the three bytes you’re replacing. You 
can put them back before you return.” 

“But, jack, I still return to the wrong 
place!” 

“Hold it a minute! I can fix up the return 
address on your stack to back it up three 
bytes. Then you’ll return to the code you’ve 
replaced and restored. That’ll be a break¬ 
point that I can really use.” 

“Glad to help you. But, jack, you still 
have to know where to breakpoint. We’re 
scarcely better off than we were with 
MIKBUG. True, the program can now con¬ 
tinue after your breakpoint. Is that all you 
wanted?” 

“It’s enough for right now, but we’ll 
probably extend it later. Please assemble 
this code.” Jack placed a cassette in the 
drive and pressed PLAY, jack smiled. “It’s 
the only sure way to keep it quiet.” 


“Computer, I want to extend Bob’s 
breakpoint.” 

“It was only a matter of time. I suppose 
you want a full trace now.” 

“Right. It isn’t that much more. All a 
trace is is a moving breakpoint.” 

“If you can’t figure out where you want 
your breakpoint, then you make me push it 
around through your stuff. Why is it that I 
always have to bail you out of your 
problems?” 
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“That’s what I built you for, remember?” 

“Calm down, Jack. 1 was only kidding.” 

“I didn’t build your sense of humor, 
that’s for sure! Anyway, here’s how you’ll 
trace a program. Start with a breakpoint. 
You handle it in the usual way, except that 
before you return you put a new breakpoint 
where the next instruction will be. Effective¬ 
ly, this breakpoints every instruction!” 

“Some things are easy to state in words 
but hard to code. How do I figure out where 
my next instruction is? I have instructions 
of different lengths in my op code set. I 
might jump or branch. . 

“Computer, remember the Thompson 
Lister’ program on page 99 of the October 
1976 BYTE? It could figure out how long an 
instruction was by disassembling your code 
in memory. Well, I’m going to give you a 
version of that algorithm so that you can 
find the next op code. It’ll also help you for¬ 
mat the instruction printout for my ease in 
reading.” 

“Fine, . .if you think you’re up to it. 
Besides, I remember that the Thompson 
Lister’ couldn’t catch invalid instructions. 
Sometimes you stick data into a subroutine 
return address and force me into the middle 
of nowhere!” 

“1 remember that incident well enough. 
I’ll add a table of invalid op codes so that 
you can call me names when you hit one.” 

“This I like.” 

“I thought you would. Now, think you 
can trace?” 

Computer sat with lights quivering. “I’ve 
got problems. Jack. You’ve given me a way 
to find the next instruction in most cases, 
but what about jumps or branches? Knowing 
the length of the instruction is no help.” 

“True. I guess we’ll need a set of special 
cases.” 

“Oh boy. Here we go.” 

“It won’t be too bad.” Jack didn’t sound 
too convinced. “Let’s start with the jumps. 
There are subroutine jumps and uncondi¬ 
tional jumps. They can be indexed or ex¬ 
tended addressing.” 

“The subroutine stuff doesn’t matter. 
Jack. For my purposes, a jump is a jump. 
All I need is the location of the end of the 
jump.” 

“Fine. So, we’ll have two special cases: 
extended jumps and indexed jumps. The 
extended jumps are easy; the second and 


third byte of the instruction are the address 
you require to set your new breakpoint.” 

“Done.” 

“The indexed jumps need the contents 
of the index register from the target pro¬ 
gram, but you have saved that! You have 
the offset in the second byte of the instruc¬ 
tion! Do a simple addition and you have the 
new breakpoint address!” 

“It’s simple if you give me a 16 bit addi¬ 
tion program.” 

“Surely. Now for subroutine returns. 
You can get the return address from the 
stack. You’ve saved the target program stack 
pointer, so you can get the top of the target 
stack for your new breakpoint. That’s 
special case 3.” 

“But what about all the branches?” 

“That will take a bit of work. Let’s work 
on the unconditional branches first; they’re 
simpler. You do know where the target 
program is because you’ve got its program 
counter saved. You get the offset from the 
second byte of the instruction. You just add 
the offset to the program counter.” 

“What about signs, Jack?” 

“Oh, yes. Forgot about that.” 

“I noticed that.” 

“All right, computer. You get a gold 
star! If the offset is negative, you must 
subtract it from the program counter. I’ll 
give you a 16 bit subtract too.” 

“All that for just unconditional branches! 

I shudder to think what the conditional 
branches will need.” 

“Not too much more. We just have to 
decide whether the branch will be executed 
or not. If not, then the branch is just 
another 2 byte instruction. If it is to be exe¬ 
cuted, then it is equivalent, for your pur¬ 
poses, to an unconditional branch. You’ve 
already got code to handle each case.” 

“Yeah, but how do I know if the branch 
is to be executed? ESP?” 

“Nothing but good, clever programming 
is needed here. You have the condition 
codes from the target program saved away. 
You have the op code, the type of branch. 
All it takes is a little trick. You’ll copy the 
branch into a spot in the trace code and set 
the condition codes from your save area. 
Then, if the branch falls through, you know 
to treat it as a normal 2 byte instruction. 
The branch will tell you when to use your 
branch code. Simple, huh?” 
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“Self-modifying code.. .very poor form, 
Jack!” 

“Can you do it better?” 

“No.” 

“Then stop complaining. It’s effective; 
it works. Don’t knock it.” 

“At least it will have your name on it 
and not mine. Any more special cases?” 

“A few. We’ve got to take care of the 
interrupt instructions RTI and WAl and 
SWI. Why anybody would try to trace a pro¬ 
gram with interrupts going off is beyond me, 
but we’d better be complete. They won’t 
be hard to handle.” 

“Thank God!” 

“Since when did you get religious? Any¬ 
how, the RTI is just like the subroutine 
return; just the return address is deeper on 
the stack.” 

“That was relatively painless. 1 can figure 
out the SWI code myself. 1 know the soft¬ 
ware interrupt will get a handler address 
from its vector, which, since I have MIK- 
BUG, is in ROM. My new breakpoint goes 
at the address found in the vector.” 

“Very good, computer. Now, the WAl is 
a bit of a problem. You can’t know whether 
the interrupt that will get you out of wait 
state will be an IRQ or an NMl. They have 
different vectors. We’ll just have to pick one 
and warn the user of my tracer that the 
other type of interrupt causes problems.” 

“The IRQ is used more often, so 1 guess 
I’ll get my new address from the IRQ 
vector.” 

“I guess that’s a good choice.” 

“Done with special cases, Jack?” 

“I think so. Here, I’ll load this program 
and you try to trace it.” 

Computer began to trace. Jack smiled as 
the printout overflowed down the printer. 
Suddenly, the printing stopped. Jack 
punched RESET. 

“I was going good there, wasn’t I, Jack?” 

“Yeah, but why did you stop?” 

“You had this call to MIKBUG in the tar¬ 
get program. I traced the next instruction 
and put my breakpoint out, but then every¬ 
thing fell apart.” 

“Of course, of course! You can’t put 
breakpoints into ROM! You can try to store 
anything you want, the data won’t change! 
When you breakpoint, check that your 
breakpoint is going in. If not, quit before 
you get lost in thought.” 


“Now you tell me!” 

“Better late than never. Now let’s see, we 
can’t trace through ROM or nonexistent 
memory and we can’t tolerate nonmasked 
interrupts at all, or IRQs unless we were in 
a wait for interrupt state. Can you think of 
any other places we’d have trouble?” 

“Well, if you hit my RESET then I’ll 
have trouble. 1 might not have fixed up my 
breakpoint yet.” 

“Right. Tell you what: every time you fix 
up the code after having traced an instruc¬ 
tion, wait for me to hit a key on the console. 
This will let me stop tracing cleanly.” 

“Glad to oblige. Now, your favorite 
trick of modifying instructions could cause 
problems. If an instruction tries to modify 
the instruction I’ve tried to breakpoint, 
well, kaboom!!!” 

“Very graphic.” 

“You’re buying me some graphics 
equipment?” 

“No, my eager processor. Perhaps a 
muzzle. . .” 

“Okay. Beware of tracing programs 
which use modifying instructions. You 
shouldn’t write them that way anyhow.” 

“Computer, try tracing this now.” 

The stream of printout began again, with 
Jack periodically tapping the carriage re¬ 
turn key. “Wait a minute, wait a minute! 
Computer, you’re getting some of these 
branches screwed up.” 

“I’m just doing what you said to do.” 

“Well maybe I was wrong.” 

“Please publish that last comment, 
Jack! I want that admission in writing!” 

“Okay. Now, what’s the problem? Why 
do some branches trace properly and others 
don’t?” Jack poured over the printout 
while computer hummed contentedly. 

“Bob! Come here and look at this!” 
(Enter Bob, who really was there all the 
time, but didn’t say much.) Bob scanned 
the trace listing. 

“You always get forward branches right. 
That must be a clue. What is it about back¬ 
ward branches? You get some of them 
right.” Bob thought some more. 

“Oh, sure!” Bob jumped to the console 
again, papers falling to the floor. “If you 
branch backwards less than three bytes, 
then your new breakpoint overlaps the 
present instruction!” 

“Fine, Bob. Now what are we to do 
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about that? My breakpoint has to be three 
bytes long.” 

“Yes, but this problem only happens on 
backwards branches, A branch doesn’t 
change anything in the target program ex¬ 
cept the program counter. In fact, it needn’t 
be executed at all. We just change the return 
address from the trace routine to get back to 
the right place in the target program! We 
return to the breakpoint call, not the 
branch! It’s easy.” 

“Fine, Bob. Can I rest now? It’s been a 
long time since I had some time to myself. 
All work and no play makes Jack’s com¬ 
puter dull.” 

“Computer!” 

“What is it. Jack? I was just reading that 
new language you guys have been working 
on, STRUBAL. Bob wants rrie to compile it 
for him. It looks like a big project.” 

“Well, right now 1 want you to help me 
extend our debugger.” 

“You never give up, do you, Jack?” 

“With such an able assistant, why should 
I?” 

“That’s hitting below the belt.” 

“You don’t have a belt, computer.” 

“1 forgot,” said computer sheepishly. 
“What now?” 

“Your tracing is very helpful, but I’d like 
to be able to fix the errors that I find 
without reloading the program and retracing 
my steps.” 

“Would you say ‘our steps’?” 

“If you insist.” 

“I do.” 

“Okay. We don’t want to retrace our 
steps. We need more of MlKBUG’s capa¬ 
bilities in the debugger. 1 want to be able 
to change the register contents In the target 
program.” 

“After I spend so much effort saving the 
contents?” 

“Yes. If I find that a register has the 
wrong thing in it, then I’ll want to correct 
the register before you go on to the next 
instruction.” 

“Well, that’s no big deal. I just change 
my stored value for that register. Then, 
when 1 return to the target program, the 
register will have what you want in it. How 
will you tell me which register to change?” 

“I thought a lot about that, and I think I 
will use the console input that now tells you 


to go on. From now on, if I type a carriage 
return, then go to the next instruction. If 
1 type a capital A, then I want to change 
your A register. If 1 type a capital B, then I 
want to change your B register. Similarly, 
X and S indicate your index and stack 
registers. Just after the input you can wait 
for me to type in the new value I want in 
that register,” 

“I suppose I keep letting you change 
registers until you get around to a carriage 
return?” 

“Right, and, if 1 type something that 
doesn’t correspond to a register, just skip it. 
Prompt me for another input.” 

“Yes sir, boss. Let me anticipate your 
next request. You want to be able to change 
memory locations, like MIKBUG does.” 

“Right again! We’ll indicate that with a 
capital M. I’ll enter the address. You give me 
the present contents and then let me type 
my desired value for that location.” 

“Done. I’m going to add a feature that 
might be useful. I’ll automatically convert 
lower case letters to upper case. Then you 
won’t have to worry about case shifting on 
that fancy console.” 

“That’s a good idea. Thanks.” 

“Glad to help. At least it will keep the 
swearing down when you forget to shift.” 

“Yes.” 

“Jack, I’ve got a question.” 

“What?” 

“If you can change registers and memory 
at will, can’t you get me into situations 
where I can’t continue a trace? Especially 
if you muck around with the stack.” 

“I guess that’s true, but let the user be¬ 
ware. 1 don’t expect you to protect against 
every stupidity that a programmer may 
come up with. All the legitimate cases I 
can think of will work correctly. After all, 
the trace program is only about one 
kilobyte.” 

“I’m glad you said that and not me.” 

“Computer, we understand each other.” 

“Yeah, Jack. Now can 1 go back to read¬ 
ing STRUBAL?” 

“I suppose so.” 

“Jack, would you put a clean cassette in 
drive 1? I think I may be needing it.” 

“Sometimes I wonder who works for 
whom,” muttered Jack as he reached for 
the bulk eraser. He dropped the cassette 
into the drive. It began to slowly'and in- 
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exorably turn. 

“Computer, load the tracer program, 
please.“ 

“You want to change it againV 

“Don’t get steamed up. I just want to run 
an example to test out the tracer.” 

“What target program should I load?” 

“You don’t need one,” 

“Come on. Jack, be serious. Of course 
I need a target program. You don’t expect 
me to trace memory garbage. You don’t 
mean that, do you. Jack?’’ 

“You’ve already loaded a program; 
let’s trace that.” 

“Trace the tracer. Clever! That will 
really show that tracing doesn’t upset the 
target program. Okay, I’m ready.” 

“Go.” 

“What address in the program do you 
want to start at?” 

“How about 212 hexadecimal?” 

“212 it is. Here are your registers: index, 
condition code, B, A, and stack pointer. 
The instruction is aCLR B, hexadecimal 5F. 
What would you like?” 

“Continue trace.” Computer traced the 
next instruction. Jack typed a carriage re¬ 
turn and computer traced again. Again Jack 
hit the return and computer traced. Jack 
hit yet another carriage return. Computer 
traced the instruction at 219. 

“Why don’t you show off some of your 
register change stuff? You’re at a compare A 
with 8C immediate instruction; why not 
make A equal to 8C?” 

“Fine. Do it.” 

“Done. What now?” 

“Continue tracing.” 

“The tracing tracer traces, and having 
traced, moves on.” 

“Can the poetry and just trace the pro¬ 
gram, if you don’t mind.” 

Computer traced the next ten instruc¬ 
tions without comment. “Let’s show some 
of the other debug stuff.” 

“Okay. Change the B register to FF.” 

“Done.” 

“Change the index register to 1234.” 

“Roger.” 

“Change the condition codes in the tar¬ 
get program to Dl.” 

“That’s cute. Jack. What does it mean?” 

“Just do it.” 

“All right. How about a memory change? 


I Ve got lots of memory that isn’t being used 
right now.” 

“Fine. Look at location 500.” 

“It’s got 22 in it now.” 

“Make that 44, computer.” 

“Your wish is my command.” 

“Continue the trace.” 

“I’m at lOB now. It’s a jump to 
MIKBUG.” 

Jack hit a carriage return. 

“Got to stop here. Jack. I can’t trace 
ROM. Try a new address?” 

“No, I think that will make a sufficient 
example.” Jack turned and walked toward 
the kitchen. He almost imagined that he 
heard a sigh from the workshop. He ig¬ 
nored it. 


And when Tracer was done. Jack's com¬ 
puter sent his printer the foliowing listing 
of tracer tracing tracer, ultimate confir¬ 
mation of the program's operation, in this 
listing, the lines which are blank except 
for single colons illustrate inputs of carriage 
returns to cause the program to proceed 
with tracing the next instruction. 


ENTER START-TRACE ADDRESS* 0212 


X 

*0212 

CC 

D0 

B 

02 

A 

8C 

SP 

A042 

-ADDRESS 

0212 

INSTRUCTION 

5F 

*0212 

04 

00 

8C 

A042 

0213 

FE 0173 

* 02 1 6 

D0 

00 

8C 

A042 

0216 

A6 00 

*0216 

08 

00 

A6 

A042 

0218 

08 

*0217 
*A 8C 

D8 

00 

A6 

A042 

0219 

81 8C 

*0217 

D4 

00 

8C 

A042 

02 IB 

27 1C 

*0217 

D4 

00 

8C 

A042 

0239 

5C 

*0217 

D0 

01 

8C 

A042 

023A 

5C 

*0217 

D0 

02 

8C 

A042 

023B 

5C 

*0217 

D0 

03 

8C 

A042 

023C 

F7 0172 

*0217 

1 

D0 

03 

8C 

A042 

023F 

5A 

*0217 

D0 

02 

8C 

A042 

0240 

27 09 

0217 

D0 

02 

8C 

A042 

0242 

5A 

0217 

t 

00 

01 

8C 

A042 

0243 

27 03 

*0217 

D0 

01 

8C 

A042 

0245 

BD 010B 


:B FF 
tX 1234 
:C Dl 
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T racer 


Program Notes 


This program was written as an aid to 
debugging machine language programs on 
Motorola 6800 microprocessor systems and 
was designed as an extension to MIKBUG 
(Motorola’s monitor ROM), which is rather 
weak in debugging facilities. It provides pro¬ 
gram tracing and register modification func¬ 
tions, extends the MIKBUG memory-change 
functions and is capable of detecting illegal 
instructions or other bad code. Consisting 
of less than 1 K bytes, it is a small package 
and can be loaded anywhere in memory. 
It cannot be put in ROM in its present 
form, however, since instruction modifica¬ 
tion is used in one spot. It can be used in 
systems without MIKBUG if 10 routines 
are provided to replace those present in 
MIKBUG. The 10 subroutine calls are made 
through jumps at the beginning of the 
program (see listing 1, lines 30 to 37). 
This facilitates patching the calls to suit 
other system monitors. Eight routines are 
used: 

BADDR accepts four hex characters from 
the input device and returns the binary value 
in the index register. 

BYTE accepts two hex characters and 
returns the binary value in the A register. 

INEEE accepts a single ASCII character 
and returns it in the A register. 

OUT2H outputs two hex digits (one byte) 
to the console device. The byte is pointed 
to by the index register. 

OUT2HS is equivalent to OUT2H, except 
that a space is output after the two hex 
characters. 

OUT4HS outputs four hex digits (2 bytes) 
pointed to by the index register, followed by 
a space. 

OUTS outputs a single space to the con¬ 
sole. 

PDATA outputs a string of ASCII codes 


to the console until an end of string code 
(hexadecimal 04) is encountered. The 
pointer to the string is in the index register. 

The stack must be moved to the appro¬ 
priate address in the system. This patch 
appears at location INITER (line 68 of 
listing 1). 

The program shown here was assembled 
on a 6800 system using Jack Hemenway’s 
relocating assembler. All absolute addresses 
are in the entended (2 byte) form, despite 
the fact that the assembly starts at address 
zero. To relocate the program to any other 
address, add the starting address to every 
memory reference flagged as relocatable 
by the letter “R” in the listing just to the 
left of the label field. Note that jack’s 
assembler does not list the code for FCC 
assembler pseudo operation. This operation 
produces ASCII strings with one byte per 
character in the string. To enter the program 
from the listing, users must supply the hexa¬ 
decimal equivalent of the ASCII strings, as 
found in table 2 on page 21, identified by 
their address in the listing. 

Initialization And Outputs 

To run the program, load it in memory 
(with relocation if necessary) and begin 
execution (either at the top or at INITER). 
It will then prompt the user for a starting 
address. This should be the location in 
memory where one wants to begin debug¬ 
ging. This location should be four hexa¬ 
decimal digits and should be the first byte 
of an instruction (if this is not the case, 
strange results will occur). When the address 
is entered, the program will print a header 
line labelling the fields in its diagnostic 
output. Then it will print the target programs 
register contents (Index register, condition 
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codes, B accumulator, A accumulator, stack 
pointer), the address, and the instruction at 
that address (one to three bytes). All printout 
is in hexadecimal form. Remember that 
these values are true in the target program, 
not necessarily in the Tracer. After this line, 
tracer will print a colon (:) as a prompt and 
wait for user input. 

Inputs 

The legal inputs are: letters A, B, C, M, 
S, X in either upper or lower case, and a 
carriage return. All other inputs will be 
ignored and another prompt will be issued. 
The letters refer to the registers in the 
Motorola 6800 microprocessor and a carriage 
return causes Tracer to move on to the 
next instruction to be executed in the target 
program though not necessarily the next 
sequential location. One instruction, that at 
the address entered, is executed in the target 
program and the registers are displayed again. 
The other inputs allow the user to modify 
the register contents or to alter memory 
locations in the target program. A, B, and C 
follow the same syntax. After the letter is 
input. Tracer prints a space and waits for 
two hex digits. This value replaces the 
previous value in the register and a new 
prompt is issued (the letter C refers,to the 
condition code register). S and X are similar, 
except that the new value consists of 4 hex 
digits. The S refers to the stack pointer. 
M operates like the Motorola MIKBUG 
memory change function: After the M, 
Tracer prints a space and waits for an 
address. After the address Tracer prints 
a space, the present value of the byte at 
that address, and a space, then waits for 
the user to type in two hex digits to form 
the new value at that address. The lettered 
commands may be entered In any order 
and any number of changes can be made 
at one time. Tracer will not leave the current 
instruction until it senses a carriage return. 

Restrictions 

Since Tracer is using a software break¬ 
point, there are some restrictions to its use. 
Read only memory (ROM, EROM) cannot 
be traced. Tracer checks at each step to 
insure that the next address to be traced is in 
user programmable memory. If it finds that 
it cannot trace the next step, it will prompt 
the user for a new starting address as an indi¬ 


cation that it cannot trace further. This 
also occurs if the program runs out of 
memory. 


Leaving Tracer 

Tracer is an infinite loop. It will run until 
one stops it by a restart or other interrupt. 
Restarts should be performed after a prompt 
for user input. Restarting at other times can 
leave garbage in random locations in 
memory. 

Interrupts 

Nonmaskable interrupts (NMI) cannot be 
handled by Tracer at all. In fact, it would 
be rather difficult to trace any interrupt 
process. Interrupt instructions (WAI, RTI) 
can be traced, so long as no actual interrupts 
are occurring. 

Self Modifying Code and 
Undefined Op Codes 

Undefined instructions will be flagged as 
such and Tracer will quit with a prompt for 
a new address. Some tricky uses of one 
instruction modifying another will not trace 
properly. One word of caution; because of 
this program’s extreme flexibility, the user 
should be able to find many ways of getting 
into trouble. This is the price one pays for 
such versatility. 

Extension Possibilities 

Tracer is readily expandable to include 
more and fancier capabilities. Through the 
use of a mnemonic table accessed through 
the hexadecimal instruction byte. Tracer 
could give the instruction as a mnemonic 
rather than as a hexadecimal value or, it 
could be given hexadecimal arithmetic 
capability for address calculations during 
debugging. There are other facilities that 
could be nice in some conditions; if Tracer 
was waiting at a prompt, it could be left 
through a restart and re-entered at label 
BB1. Thus, one could use other programs 
to help in debugging while Tracer is retained. 
In extending or modifying Tracer, remember 
an Important point: the debugger shouldn’t 
become so complex that it becomes a source 
of trouble rather than an aid in rooting out 
troublesome bugs. 
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Listing 1: Tracer assembiy and source iis ting. 


0001 
0002 
0003 
0004 
000b 
0006 
0007 
000b 
0009 
00 10 
001 I 
0012 
001 3 
0014 
001 5 
0016 
0017 
00 lb 
0019 
0020 
0021 
0022 
0023 
0024 
002b 
0026 
0027 
002b 
0029 
0030 
003 1 
0032 
0033 
0034 
0035 
0036 
0037 
003b 
0039 
0040 
0041 
0042 
0043 
0044 
004b 
0046 
0047 
004b 
0049 
0050 
00b I 
00b 2 
0053 
0054 
0055 
0056 
0057 
0058 
0059 


0000 0000 N 
0000 7E 007A R 


0003 7E E047 
0006 7E E05b 
0009 7E E lAC 
OOOC 7E EOBF 
OOOF 7E EOCA 
0012 7E E0C8 
00 15 7E EOCC 
00 lb 7E E07E 

0018 A042 


00IB OUOA 
00 ID 20 
003B 49 
0046 2004 

0048 ODOA 
004A 3AO4 

004C ODOA 
004E 4b 
0068 2004 

006A BD 

006B 0097 R 

006D 0001 
006E 0002 
0070 0002 


★ 

TTT 

RRR A 

CCC 

EEE RRR 

★ 

T 

HR A A 

C 

E R R 

it 

T 

R RR A AA 

c 

EE RRR 

it 

T 

RR A A 

c 

E RR 

ic 

★ 

it 

T 

R R A A 

CCC 

EEE R R T.M 

★ 

NAM 

TRACER 



★ 

JMP 

INITER 


START VECTOR 

★ 

★ 

A TRACE 

PROGRAM FOR THE 

MOTOROLA 6800 

★ 

ir 


MICROPROCESSOR 

• 

★ 

COPYRIGHT C 1977 

BY ROBERT D. GRAPPEL 

★ 

LEXINGTON MASS. 

AND 

JACK E.HEMENWAY 

★ 

* 

BOSTON 

MASS. ALL 

RIGHTS RESERVED 


* TRACE FAILS ATi 

* I. ILLEGAL INSTRUCTIONS 

* 2. RESTARTS 

*3. NMI INTERRUPTS 

* 4. ROM OR UNIMPLEMENTED MEMORY FOUND 

* 5. INSTRUCTION MODIFYING NEXT INSTRUCTION 

* 

* USES FOLLOWING MIKBUG LOCATIONS 

* (MIKBUG IS TRADEMARK OF MOTOROLA, INC.) 

* 


BADDR 

JMP 

$E047 


BYTE 

JMP 

$E05b 


INEEE 

JMP 

$E lAC 


0UT2H 

JMP 

$E0BF 


0Ur2HS 

JMP 

$E0CA 


0UT4HS 

JMP 

$E0Cb 


OUTS 

JMP 

$EOCC 


PDATA 

JMP 

$E07E 


STACK 

* 

EQU 

$A042 


* 

TRACER 

FDB 

$ODOA 

TRACE LINE PROMPT 


FCC 

' X 

CC B A SP-ADDRESS ' 


FCC 

'INSTRUCTION' 

1 

it 

FDB 

$2004 


CRLF 

FDB 

FDB 

$ODOA 

S3A04 

CR ,LF,COLON 

PRMPT 

FDB 

$ODOA 

INITIALIZER PROMPT 


FCC 

'ENTER 

START-TRACE ADDRESSi' 

if 

FDB 

$2004 


BPNTC 

FCB 

$BD 

'JSR BPHAND ' 

it 

FDB 

BPHAND 


LEN 

RMB 

1 

LENGTH OF INSTRUCTION 

PROGC 

RMB 

2 

PROGRAM aiUNTER 

STACKP 

RMB 

2 

STACK POINTER 
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0060 0072 
0061 0074 
0062 0 07b 

0063 0076 

0064 0077 

0065 
0066 
0067 

0068 007A 

0069 0070 

0070 0030 

0071 0083 

0072 0086 

0073 
0074 
0075 

0076 0089 

0077 008C 

0078 008r 

0079 0092 

0080 0095 

0082 
008 3 

0084 009 7 

0085 0098 

0086 0099 

0087 009C 

0088 009h' 

0089 00AO 

0090 OOA3 
0091 00A6 

0092 00A9 

0093 00AC 

0094 OOAF 
0095 0 082 

0096 0085 

0097 0088 

0098 00 BB 

0099 008E 

0100 OOCI 
0101 00C2 

0102 00C3 

0103 00C6 

0104 00C9 

0105 OOCC 
0106 OOCF 
0107 OOD2 
0108 OOD5 
0109 0006 

Olio 0008 

0111 00D9 

01 12 OOOA 
0113 OODB 
0114 OODE 
0115 OOEl 
0116 00E4 

01 17 00E5 

0118 00E7 

;^I19 00E9 


0002 

0001 

0001 

0001 

0003 


8E A042 
CE 004C R 
80 0018 R 
80 0003 R 
FF 0072 R 


CE 0018 R 
BO 0018 R 
FE 0072 R 
BO 02CB R 

6t 00 


36 

07 

87 0074 R 
FF 0072 R 
32 

B7 0076 R 
F7 0075 R 
BF 0070 R 
CE 0048 R 
BO 0018 R 
CE 0072 R 
BD 0012 R 
BO OOOF R 
80 OOOF R 
BD OOOF R 
FE 0070 R 
08 
08 

FF 0070 R 
CE 0070 R 
BO 0012 R 
BO 0015 R 
BO 0015 R 
BD 0015 R 
30 

EE 00 
09 
09 
09 

FF 006E R 
B6 006E R 
F6 006F R 
30 

E7 01 
A7 00 
FE 006E R 


XREG RMB 2 

CCODE RMB 1 

BREG RMB 1 

AREG RMB 1 

STORE RMB 3 

★ 

* initializer SECTION 

★ 

I NITER LOS #STACK 
LDX #PRMPT 
JSR POATA 
JSR 3ADDR 
Sl’X XREG 

* 

* SET BREAKPOINT (JSR 

* 

LOX #TRACEP 
JSR POATA 
LDX XREG 
JSR SETBPT 
JMP 0,X 

* BREAKPOINT 

★ 

BPHANU PSH A 
TPA 

STA A CCODE 
STX XREG 
PUL A 

STA A AREG 
STA B BREG 
SfS STACKP 
LOX #CRLF 
JSR POATA 
LOX #XREG 
JSR 0UT4HS 
JSR 0UT2HS 
JSR 0UT2HS 
JSR 0UT2HS 
LDX STACKP 
INX 
INX 

SrX STACKP 
LDX #STACKP 
JSR 0UT4HS 
JSR OUTS 
JSR OUTS 
JSR OUTS 
TSX 

LOX O.X 
DEX 
DEX 
OEX 

STX PROGC 
LOA a PROGC 
LOA B PROGC+1 
TSX 

STA B l,X 
STA A 0,X 
LDX PROGC 


X-REGISTER 
CONDITION CODES 
B-REGISTER 
A-REGISTER 


I NIT. STACK 

PRINT PROMPT 

GET STARTING ADDRESS 


BPHAND) 

PRINT HEADER 


SAVE MACHINE STATUS 
(CONDITION CODES) 


LINEFEED 


OUTPUT X-REGISTER 
OUTPUT C-COUE 
OUTPUT B-REGISTER 
OUTPUT A-REGISTER 
GET REAL STACK POINTER 


OUTPUT STACK POINTER 
SPACES 


BACK UP RETURN ADDRESS 
BY 3 BYTES 


BYTE 3 OF INSTRUCTION 


BEGIN TRACING 
HANDLER SECTION 
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0 120 

ooec 

B6 0079 

R 


LDA A STORE+2 


0121 

OOEF 

A7 02 



STA A 2»X 


0122 

OOF 1 

B6 0078 

R 


LDA A STORE+1 

BYTE 2 

0123 

00F4 

A7 0 1 



STA A 1,X 


0124 

00 F6 

B6 0077 

R 


LDA A STORE 

BYTE 1 

0125 

00F9 

A7 00 



SFA A 0,X 


0126 




★ 



0127 




★ NOW DECODE INSTRUCTION 

01 2d 




ir 



0129 

OOFB 

CE 006E 

R 


LDX #PROGC 


0 130 

OOFE 

BD 0012 

R 


JSR 0UT4HS 

OUTPUT INSTRUCTION ADDRESS 

0131 

0101 

BD 0015 

R 


JSR OUTS 

SPACE 

0132 

0104 

BD 0015 

R 


JSR OUTS 

SPACE 

0133 

0107 

F£ 006E 

R 


LDX PROGC 


0134 

0 lOA 

BD 000F 

R 


JSR 0UT2HS 

OUTPUT INSTRUCTION BYTE 

0135 




★ 



0136 




* NOW COMPUTE INSTRUCTION LENGTH 

0137 




* PARTIAL DISASSEMBLY 

DONE HERE 

0138 




ic 



0139 

0 lOD 

5F 



CLR B 

LENGTH=I 

0140 

OlOE 

FE 006E 

R 


LDX PROGC 


014 1 

0111 

A6 00 



LDA A 0,X 

GET INSTRUCTION BYTE 

0143 




* 



01 44 




★ ILLEGAL INSTRUCTION 

TRAP 

0145 




★ 



0146 

01 13 

CE 0135 

R 


LDX #ILTBL 

POiNi TO BAD CODE FABLE 

0147 

0116 

Al 00 


ILLCX)P 

CMP A 0,X 

FESr MATCH 

0148 

01 18 

27 08 



BEQ BADCOD 

FOUND MATCH? 

0149 




★ 



0150 

01 lA 

08 



I NX 


015 1 

0 113 

8C 0 16F 

R 


CPX #ILEND 

END OF TABLE? 

0152 

0.1 IE 

26 F6 



BNE ILL(X)P 

NO, KEEP L(X)KING 

0 153 




★ 



0154 

0 120 

6£ 00 



JMP 0,X 

VALID OPCODE 

0155 




★ 



0156 

0122 

CE 012B 

R 

BADCOD 

LDX #BADPRT 


0157 

0 125 

BD 0018 

R 


JSR PDATA 

OUTPUT MESSAGE 

0158 

0 128 

7E 007A 

R 


JMP I NITER 

Qli I T 

0159 




★ 



0 160 

012B 

55 


3ADPRT 

FCC 'UNDEFINED^ 

0161 

0 134 

04 



FCB $04 


0102 




★ 



0163 

0 135 

0003 


ILTBL 

FDB $0003 

UNDEFINED OPCODES 

0164 

0 137 

0405 



FDB $0405 

FOR M6800 

0165 

0139 

12 13 



FDB $ 121 3 


01 66 

0 I3B 

1415 



FDB $1415 


0167 

0 13D 

181A 



FDB $18 lA 


0 168 

013F 

1C ID 



FDB $ICID 


0 169 

014 1 

IE IF 



FDB $ lElF 


01 70 

0 143 

2138 



FDB $2138 


01 71 

0 145 

3A3C 



FDB $3A3C 


0172 

014/ 

3D4 1 



FDB $3041 


0173 

0149 

4245 



FDB $4245 


01 74 

0 14B 

4B4E 



FDB $4B4E 


0175 

0 14D 

5152 



FDB $5152 


0176 

0 14F 

555B 



FDB $555B 


0177 

0151 

5E6 1 



FDB $5£61 


0178 

0153 

6265 



FDB $6265 


0179 

0 155 

6871 



FDB $6871 
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0180 
018 I 
0182 
0183 
0184 
0186 
0186 
0187 
0188 
0189 
0190 
0191 
0192 
0193 
0196 
0196 
0197 
0198 
0199 
0200 
0201 
0202 
0203 
0204 
0206 
0206 
0207 
0208 
0209 
0210 
0211 
0212 
0213 
0214 
0216 
0216 
0217 
0218 
0219 
0220 
022 1 
0222 
0223 
0224 
0226 
0226 
0227 
0228 
0229 
0230 
0231 
0232 
0233 
0236 
0236 
0237 
0238 
0239 
0240 


0157 7276 
0159 7B83 
0 I5B b78F 
OI5D 939D 
OI5F A3B3 
0161 C3C7 
0163 CCCO 
0 166 CFD3 
0 167 DCDD 
0169 t3tC 
016B EDF3 
0I6D hCFD 


★ 


0 I6F 

FE 

006E 

R 

ILEND 

01 72 

08 




0 173 

81 

8C 



0 176 

27 

1C 


★ 

0 17/ 

81 

aE 



0 179 

27 

18 


★ 

0173 

8 1 

CE 



01 7D 

27 

14 


★ 

01 7F 

8 1 

8D 



0 18 1 

27 

1 1 


★ 

0 183 

84 

FO 



0 186 

81 

20 



0187 

27 

OB 


★ 

0189 

8 1 

60 



0 18B 

25 

08 


★ 

0 IBD 

84 

30 



0 I8F 

81 

30 



0191 

26 

0 1 


★ 

0193 

6C 



BJ 

0 194 

6C 



B2 

0 196 

5C 



Bl 

0196 

F7 

006D 

R 


0 199 

5A 




019A 

27 

09 


★ 

0I9C 

6A 




019D 

27 

03 


★ 

0 I9F 

BD 

OOOC 

R 

BB3 

0 IA2 

BD 

OOOC 

R 

BB2 

01 A5 

CE 

0048 

R 

BBl 

OIAB 

BD 

0018 

R 



* 


FOB $7275 
FOB $7B63 
FOB $876F 
FDB $939D 
FOB $A3B3 
FDB $C3C7 
FDB $CCCO 
FDB $CFD3 
FDB $DCDD 
FDB $E3EC 
FDB $EDF3 
FDB $FCFD 

LDX PROGC 
INX 

CMP A #$6C 
BEQ B3 

CMP A #$8E 
BEQ B3 

CMP A #$CE 
BEQ B3 

CMP A #$8D 
BEQ B2 

AND A #$FO 
CMP A #$20 
BEQ B2 

CMP A #$60 
BCS B1 

AND A #$30 
CMP A #$30 
BNE B2 

INC B 
INC B 
INC B 
SfA B LEN 
DEC B 
BEQ BBl 

Dec B 
BEQ BB2 

JSR ()UT2H 
JSR 0UT2H 
LDX #CRLF 
JSR PDAi'A 


* SiAiIJS CHANGE SECTION 

★ 

OIAB BD 0009 R JSR INEEE 

OIAE 84 DF and A #$DF 

0 160 81 OD CMP A #$OD 

0 1B2 27 6B BEQ UECOD 


RESTORE X-REGISTER 

CPX? 

3-3rrES 

LDS? 

3-BYTES 

LDX? 

3-BYTES 

BSR? 

2-BYTES 


BRANCH? 

2-BYTES 


l-BYl'E 


2- BYTES 

3- BYTE INSTRUCTION 
2-BYTE INSTRUCTION 
I-BYTE INSTRUCTION 


3-BYTE INSTRUCTION,OUTPUT 
2-BYTE 

LINE'FEED 


WAIT FOR KEYPRESS 
FORCE UPPER CASE 
CR? 

IF SO, CONTINUE TRACE 
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0241 
0242 
0243 
0244 
024b 
0246 
0247 
024d 
0249 
0250 
0251 
0252 
0253 
025 4 
0255 
0256 
0257 
0258 
0259 
0260 
0261 
0262 
0263 
0264 
0265 
0266 
0267 
0268 
0269 
0270 
0271 
0272 
0273 
0274 
0275 
0276 
0277 
02 78 
0279 
0280 
028 1 
0282 
0283 
0284 
0285 
0286 
0287 
0288 
0289 
0290 
0291 
0292 
0293 
0294 
0295 
0296 
029 7 
0298 
0299 


0164 

81 

4 1 


★ 

CMP A #$4 1 

"A"? 

0 IB 6 

26 

OB 



BNE NEXTI 

NO 





* CHANGE 

: A-REGISIER 

CONTbNTS 

0 IB 8 

BD 

0015 

R 


JSR OUTS 

SPACE 

0 136 

BD 

0006 

R 


JSR BYTE 

GET DATA 

01 BE 

B7 

0076 

R 


SI'A A AREG 

STORb IT 

0 ICI 

20 

E2 



BRA B 8 I 

GET\ NEW KEY 

0IC3 

8 1 

42 


NEXT 1 

CMP A #$42 

"B"? 

OfC5 

26 

OB 


ic 

BNE NEXT2 

NO 





* CHANGE 

: B-REGISTER 

CONTENTS 

0 IC / 

BD 

0015 

R 


JSR OUTS 

SPACE 

OICA 

BD 

0006 

R 


JSR BYTE 

GET DATA 

0 ICO 

B7 

0075 

R 


STA A BREG 

STORE IT 

OJOO 

20 

03 



BRA BB 1 

GET NEW KEY 

0 102 

8 1 

43 


N£XT2 

CMP A #$43 

"C? 

0 104 

26 

OB 



BNE NEXf3 

NO 





* CHANGE CONDITION 

CODES 

0 106 

BD 

0015 

R 


JSR OUTS 

SPACE 

0109 

BD 

0006 

R 


JSR BYTE 

GET DATA 

01 DC 

B7 

0074 

R 


SEA A CCODE 

STORE IT 

0 IDF 

20 

C4 



BRA BBI 

GET NEW KEY 

Olt 1 

8 1 

4D 


ft 

NEXT3 

CMP A #$4D 

••M"? 

0 Ib3 

26 

1C 



BNE NEXT4 

NO 


★ 


* CHANGE MEMORY LOCAI'ION 


0 IE5 

BD 

00 15 

R 

★ 

JSR 

OUTS 

SPACE 

0 IE 8 

BD 

0003 

R 


JSR 

BA DDR 

GET MEMORY ADDRESS 

OIEB 

FF 

0077 

R 


STX 

STORE 


OlEb 

BD 

0015 

R 


JSR 

OUTS 

SPACE 

OIFI 

F£ 

0077 

R 


LDX 

STORE 


0 IF4 

BD 

OOOF 

R 


JSR 

0UT2HS 

PRINT CONTENTS 

01F7 

BD 

0006 

R 


JSR 

BYTE 

GET DATA BYTE 

0 IFA 

Fb 

0077 

R 


LDX 

STORE 


OIFD 

A7 

00 



STA 

A 0,X 

STORE IT AT ADDRESS 

0 1 FF 

20 

A4 



BRA 

BBI 

GET NEW KEY 

0201 

81 

53 


ft 

NEXT4 

CMP 

A #$53 

11511 ? 

0203 

26 

OB 



BNE 

NEXT5 

NO 





* CHANGE STACK POINTER 


0205 

BD 

0015 

R 


JSR 

OUTS 

SPACE 

0208 

BD 

0003 

R 


JSR 

BA DDR 

GET NEW VALUE 

0203 

FF 

0070 

R 


STX 

STACKP 

STORE IT 

020 b 

20 

95 



BRA 

BBI 

GET NEW KEY 

02 10 

8 1 

58 


NbXl'5 

CMP 

A #$58 

"X"? 

02 12 

26 

91 



BNE 

BB 1 

IF NOT, GET NEW KEY 
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0300 

0301 

0302 

0303 

0304 

0305 

0306 

0307 

0308 

0310 

0311 

0312 

0313 

0314 

0315 

03 lo 

0317 

0318 

0319 

0320 

032 I 

0322 

0323 

0324 

0325 

0326 

0327 

0328 

0329 

0330 

0331 

0332 

0333 

0334 

0335 

0336 

0337 

0338 

0339 

0340 

0341 

0342 

0343 

0344 

0345 

0346 

0347 

0348 

0349 

0350 

035 I 

0352 

0353 

0354 

0355 

0356 

0357 

0358 


* CHANGE X-REGISTER CONTENTS 


0214 BO 0015 R 
02 17 BD 0003 R 
02 lA FF 0072 R 
0 ID 20 86 


JSR OUTS 
JSR BA DDR 
STX XREG 
BRA BB I 


* 

* 


SPACE 

GET NErt VALUE 
STORE IT 
GEf NEW KEY 


02 It- F£ 006E 
0222 A6 00 


0224 8 I 6E 
0226 27 2C 
0228 81 AD 
022A 27 28 


022C 81 7E 
022E 27 20 
0230 81 BD 
0232 27 1C 


0234 8 I 8D 
0236 27 34 
0238 81 39 
023A 27 o4 


* decode special cases HcRE 

* FIND NEXT INSTRUCTION'S ADDRESS 

* 

R DECOD LDX PROGC 
LDA A 0,X 

* 

* INDEXED JUMPS HERE 


GET INSTRUCIION BYTE 


CMP A #$6E JMP X? 

BED INDEX 

CMP A #$AD JSR X? 

BEQ INDEX 

* 

* EXTENDED JUMPS HERE 

* 

CMP A #$7E JMP EXT? 

BEQ EXTEND 

CMP A #$BD JSR EXT? 

BEG EXTEND 

* 

* SUBROUTINE HANDLING 

* 

CMP A #$8D BSR? 

BEQ BRNCHI 

CMP A #$39 RTS? 

BEG RTSUB 

★ 

* INTERRUPT INSTRUCTIONS 

* 


02 3C 

81 

38 

CMP 

A #$3B 

RTI? 

023E 

27 

7 1 

BEQ 

RTIZ 


0240 

81 

3F 

CMP 

A #$3F 

S^I? 

0242 

27 

63 

BEQ 

SrtIZ 


0244 

8 1 

3E 

CMP 

A #$3E 


0246 

27 

64 

BEQ 

WAIZ 



* BRANCHES 

* 


0248 

84 

FO 


AND 

A #$FO 

024A 

81 

20 


CMP 

A #$20 

024C 

27 

I 1 

if 

BEQ 

BRANCH 

024E 

20 

68 

if 

BRA 

NORMAL 




★ 

EXTENDED JUMPS 

0250 

EE 

0 1 

EXTEND LDX 

1 ,x 

0252 

20 

77 


BRA 

SETBPT 


ALL OTHERS 


GET JUMP ADDRESS 
RESET BREAKPOINT 
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03b 9 





* INOEXED JUMPS 


0360 





* 



036 1 

0254 

5F 



INDEX 

CLR B 


0362 

0255 

A6 

01 



LDA A 1 ,X 

GET OFFSET 

0363 

0257 

BB 

0073 

R 


ADD A XREG+I 

ADD IN X-REGISTER 

0364 

025A 

F9 

0072 

R 


ADC B XREG 


0365 

0250 

20 

63 



BRA UPDATE 

RESET BREAKPOINT 

0366 





★ 



0367 





* BRANCH INSTRUCTIONS 


0368 





★ 



0369 

025F 

A6 

00 


BRANCH 

LDA A 0,X 

GET BRANCH TYPE 

0370 





★ 



037 1 





* CONDITIONAL BRANCH 

TEST 

0372 





★ 



0373 

026 1 

B7 

0268 

R 


SIA A TEST 

INSTRUCTION INSERTED 

0374 

0264 

B6 

0074 

R 


LDA A CCODE 

SET CONDITION CODE 

0375 

0267 

06 




TAP 


0376 

0268 

20 

02 


lESf 

BRA *+4 

MODIFIED INSTRUCTION 

0377 

026A 

20 

4C 



BRA NORMAL 

NO BRANC.i 

0378 





★ 



03/9 

026C 

A6 

0 1 


BRNCH 1 

LDA A 1 ,X 

GhT OFFSET 

0380 

026t 

5F 




CLR B 


088 1 

026H 

Od 




INX 

ADD 2 TO PROGC 

0382 

0270 

08 




INX 


0383 

02/1 

FF 

006c 

R 


STX PROGC 


0384 

0274 

40 




TST A 

OFFSET PLUS OR MINUS? 

0385 

0275 

20 

08 



BLT BRNCH2 

IF MINUS, SUBTRACT 

0388 





★ 



038/ 





* FORAARU BRANCH 


0388 





★ 



0389 

0277 

BB 

006 F 

R 


ADD A PR()GC+ 1 

OTHERRISE ADD 

0390 

027A 

F9 

0061 

R 


ADC B PROGC 


0391 

0270 

20 

43 



BRA UPDATE 


0392 





★ 



0393 





* BACK/^ARD BRANCH 


0394 





7 ^ 



0395 

027F 

40 



8RNCH2 

NEG A 


0396 

0280 

BO 

006 F 

R 


SUB A PR()GC+ 1 


0397 

0283 

F2 

OOdh 

R 


SBC B PROGC 


0398 

0286 

43 




COM A 

MINUS ACCUMS. 

0399 

028/ 

53 




CO M B 


0400 

0288 

8 B 

0 1 



ADD A #1 


040 1 

028A 

C9 

00 



ADC B #0 


0402 





* 



0403 

028C 

36 




PSH A 

SAVE "A" 

0404 

0280 

Ft 

0061 

R 


LUX PROGC 


0405 

0290 

09 




DEX 


0406 

0291 

09 




DEX 


0407 

0292 

A6 

00 



LDA A O.X 

REGAIN BRANCH TYPE 

0408 

0294 

8 1 

8 D 



CMP A #$8D 

CHECK FOR BSR 

0409 

0296 

32 




PUL A 

RESTORE "A" 

04 10 

0297 

27 

29 



BEO UPDATE 

IF BSR, MUST EXECUTE IT 

04 1 1 





* 



0412 

02 99 

30 



MRhT 

TSX 

MODIFY RETURN POINT 

04 13 

029a 

A/ 

0 1 



STA A 1 ,X 


04 14 

029C 

tl 

00 



STA B O.X 


04 15 

029h 

20 

22 



BRA UPDATE 

FINISH UP 

0416 





★ 
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0417 

041b 

0419 02A0 Ft 0070 R 

0420 02A3 EE 0 1 

042 1 02A5 20 24 

0422 
0423 
0424 
0425 
0426 
0427 
042b 
0429 
0430 
0431 
0432 
0433 
0434 
0435 
0436 
0437 
0436 
0439 
0440 
044 I 
0442 
0443 
0444 
0445 
0446 
0447 
044b 
0450 
045 I 

0452 J2C8 Ft 006E R 

0453 02C3 Ao 00 

0454 02Cl) B7 0077 R 

0455 J2DO F6 006A R 

0456 0203 E7 00 

0457 02J5 A6 00 

045 6 0 2 0 7 II 

0459 0 2 08 26 2E 

04o0 

0461 0 20A A6 01 

0462 0 2JC B7 0078 R 

046 3 0 20r F6 006B R 

0464 0 2 E2 h7 01 

0465 02t4 A6 01 

0466 02t6 I I 

O4o7 02t7 26 IF 

046b 

0469 02E9 A6 02 

0470 0 2 E8 B7 1079 R 

0471 02Et F6 006C R 

0472 02FI c7 02 

047 3 0 2F3 A6 02 

047 4 0 2 F5 I I 

047 5 0 2F6 26 10 


* SUBROUTINE RETURN 

* 

RTSUB LDX STACKF 
LOX I,X 
BRA SETBPT 

* 

* SOFTWARE INTERRUPT 

* 

SrtIZ LOX $FFFA 
BRA SETBPT 


'^AIZ LOX $FFF6 
BRA SETBPT 

★ 

* RETURN FROM INTERRUPT 


★ 


LOX 

PROGC 

SETBPT 

LOA 

A 0,X 


STA 

A STORE 


LDA 

6 BPNTC 


STA 

B 0,X 


LDA 

A O.X 


CBA 

BNE 

QUIT 



LOA 

A 1 ,X 


STA 

A ST()RE+ 1 


LOA 

8 BPNTC+1 


STA 

B l,X 


LDA 

A 1 ,X 


CBA 

BNE 

QUIT 

Hr 


LOA 

A 2,X 


STA 

A STORE+2 


LDA 

o BPNTC+2 


STA 

B 2,X 


LOA 

A 2,X 


CBA 

BNE 

QUIT 


GET STACK POINTER 
GET RETURN ADDRESS 

GET SrtI VECTOR 


IRO VECTOR 

GET STACK POINTER 
GET RETURN ADDRESS 

GET INSTRUCTION LENGTH 
ADD LENGTH 


NEW LOCATION 
BYTE I OF CODE 

CHECK MEMORY 

ERROR FOUND 

ScCONU BYTE 


THIRD BYTE 


02A7 FE FFFA 
02AA 20 IF 


02AC FE FFF8 
02Ah 20 I A 


Hr 

0281 FE 0070 R RTTZ LDX STACKP 

0284 EE 06 LDX o,X 

02B6 20 I 3 bra SETBPT 

★ 

* ALL OTHERS 

★ 

02B8 B6 0060 R NORMAL 
02B8 5F 

02BC B8 006F R 
02Bt- F9 006 E R 

★ 

02C2 B7 006F R UPDATE 
02Cb F7 006E R 


* RtSET BREAKPOINT AND RETURN 


GET FIRST BYTE FROM 


LDA A LEN 
CLR B 

ADD A PROGC+ I 
ADC B PROGC 

STA A PROGC+I 
STA B PROGC 


* WAI INSTRUCTION-ASSUME IRO WILL TERMINATE 
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0476 

0477 

02F6 

Ft 

0072 

R 

★ 

LDX 

XREG 

RESTORE 

X-REGISTER 

04 7 b 

02Fy 

F6 

0075 

R 


LOA 

B BREG 

RESTORE 

B-REGISTER 

0479 

02FE 

B6 

0076 

R 


LDA 

A AREG 



04b0 

0301 

36 




PSH 

A 



04b 1 

0302 

B6 

0074 

R 


LOA 

A CCOOE 



0462 

0305 

06 




TAP 


RESTORE 

CONDITION CODES 

0463 

0306 

32 




PUL 

A 

RESTORE 

A-REGISTER 

0464 

0465 

0307 

39 



★ 

Ri'S 




0466 





★ 





046 7 

0306 

7E 

007 A 

R 

QUIT 

JMP 

INITER 

ERROR TRAP 

0466 

0469 





★ 

END 





Table 7; Sorted symbol table for the above assembly. 


AREG 

0076 

R 

BRNCHl 

026C 

R 

MREF 

029V 

R 

QUIT 

0306 

R 

Bl 

0 195 

R 

BHNCH2 

027F 

R 

NcX 1 1 

01C3 

R 

RlTZ 

02B 1 

R 

B2 

0 194 

R 

BYTE 

0006 

R 

NbX i'2 

0 1U2 

R 

RTSUB 

02AO 

R 

B3 

-0193 

R 

CCODE 

0074 

R 

NEXT3 

OlE 1 

R 

SEI'BPT 

02CB 

R 

BADCOD 

0122 

R 

CRLF 

0046 

R 

NEX r4 

020 1 

R 

STACK 

A042 


BADDR 

0003 

R 

OECOD 

02 IF 

R 

NEXT5 

02 10 

R 

Si'ACKP 

0070 

R 

BADPRT 

0 I2B 

R 

EXTENU 

0250 

fi 

NORMAL 

02B6 

R 

STORE 

0077 

R 

BBI 

0IA5 

R 

ILcND 

0 I6F 

R 

0 Ui'2H 

OOOC 

R 

SNIZ 

02A7 

R 

B62 

0 IA2 

R 

ILL(X)P 

01 16 

R 

0Ur2HS 

OOOF 

R 

TEST 

0266 

R 

BB3 

0 I9F 

R 

ILiBL 

0 135 

R 

()UT4HS 

0012 

R 

TRACEP 

00 IB 

R 

BPHAND 

0097 

R 

INDEX 

0254 

R 

ours 

00 15 

R 

TRACER 

0000 

RN 

BPNTC 

006A 

R 

IN EEE 

0009 

R 

PoaTA 

0016 

R 

IJPDAi'E 

02C2 

R 

BRANCH 

025 F 

R 

INITER 

007 A 

H 

PRMPT 

004C 

R 

NAIZ 

02AC 

R 

BREG 

0075 

R 

LEN 

0060 

R 

PROGC 

006E 

R 

XREG 

0072 

R 


Table 2: Table of hexadecimal data 
for the character strings of listing 7. 
Each string is identified by its 
symbol and address as in listing 7. 


Address Hexadecimal Data for String “TRACER*' Address 


Hexadecimal Data for String “PRMPT" 


001B 

OD 

OA 

20 

20 

20 

58 

20 

20 

0023 

43 

43 

20 

20 

42 

20 

20 

41 

002 B 

20 

20 

20 

53 

50 

2D 

41 

44 

0033 

44 

52 

45 

53 

53 

20 

20 

20 

003 B 

49 

4E 

53 

54 

52 

55 

43 

54 

0043 

49 

4F 

4E 

20 

04 





Address Hexadecimal Data for String “CRLF“ 

0048 OD OA 3A 04 


004C 

0054 

005C 

0064 


Address 

012B 

0133 


OD 

OA 

45 

4E 

54 

45 

52 

20 

53 

54 

41 

52 

54 

2D 

54 

52 

41 

43 

45 

20 

41 

44 

44 

52 

45 

53 

53 

3A 

20 

04 




Hexadecimal Data for String “BADPRT” 

55 4E 44 45 46 49 4E 45 

44 04 
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Beginning on the next page is a complete machine readable representation of the object code 
for Tracer, as assembled in the listing found on pages 13 to 21 of this book. 

This Tracer representation uses the absolute loader format, in which each bar code frame 
(one line of bars running from top to bottom of the page) contains a two byte address followed 
by data which is loaded in ascending order starting at that address. 

The object code listing shown below gives the information in hexadecimal form, with one 
line per Bar Code frame for use as a confirmation copy. 

For details on the frame format and absolute loader format used in this and all Paperbyte"^ 
Books, see the Paperbyte^M Publication “Bar Code Loader” by Ken Budnick. This book, the 
first in the Paperbyte^^ series, contains a brief history on bar codes, a general barcode loader 
algorithm with flow charts and complete program listings for 6800, 6502 and 8080 or Z-80 
based systems. 


0100 7t 01 7A 7L tO 47 7L hO 55 7L hi AC 7H hO BF 7E 

0110 hO CA 7h hO C8 7h HO CC 7h hO 7h OD OA 20 20 20 

0120 58 20 20 43 43 20 20 42 20 20 41 20 20 20 53 50 

0130 2D 41 44 44 52 45 53 53 20 20 20 49 4E 53 54 52 

0140 55 43 54 49 4E 41-; 20 04 OD OA 3A 04 OD OA 45 4E 

0150 54 45 52 20 53 54 41 52 54 2D 54 52 41 43 45 20 

0160 41 44 44 52 45 53 53 3A 20 04 BD 01 97 00 00 00 

0170 00 00 00 00 00 00 00 00 00 00 8E AO 42 CE 01 4C 

0180 BD 01 18 BD 01 03 EE 01 72 CE 01 IB BD 01 18 FE 

0190 01 72 BD 03 CB 6E 00 36 07 B7 01 74 FF 01 72 32 

0 1 AO B7 0 1 7 6 F7 0 1 7 5 BF 0 1 70 CE 0 1 48 BD 0 1 18 CE 

0 1 BO 0 1 7 2 BD 0 1 12 BD 01 OF BD 0 1 OF BD 01 OF FE 01 

0 ICO 70 08 08 FF 0 1 7 0 CE 0 1 7 0 BD 0 1 12 BD 01 15 BD 

OIDO 01 15 BD 01 15 30 EE 00 09 09 09 FF 01 6E B6 01 

01EO 6E F6 01 6F 30 E7 01 A7 00 FE 01 6E B6 01 79 A7 

OlEO 02 B6 01 78 A7 01 B601 77 A7 00 CE 01 6E BD 01 
0200 12 BD 0 1 15 BD 0 1 I 5 FE 01 6E BD 01 OF 5F FE 01 

0210 6E A6 00 CE 02 35 A1 00 27 08 08 8C 02 6F 26 F6 

0220 6E 00 CE 02 2B BD 01 18 7E 01 7A 55 4E 44 45 46 

0230 49 4E 45 44 04 00 03 04 05 12 13 14 15 18 lA 1C 

0240 ID IE IE 21 38 3A 3C 3D 41 42 45 4B 4E 51 52 55 

0250 5B 5E 61 62 65 6B 71 72 75 7B 83 87 8F 93 9D A3 

0260 B3 C3 C7 CC CD CE D3 DC DD E3 EC ED E3 EC FD FE 

0270 01 6E 08 81 8C 27 1C 81 8E 27 18 81 CE 27 14 81 

0280 8D 27 11 84 FO 81 20 27 OB 81 60 25 08 84 30 81 

0290 30 26 01 5C 5C 5C F7 01 6D 5A 27 09 5A 27 03 BD 

02A0 01 OC BD 01 OC CE 01 48 BD 01 18 BD 01 09 84 DF 

02B0 81 OD 27 6B 81 41 26 OB BD 01 15 BD 01 06 B7 01 

02C0 76 20 E2 81 42 26 OB BD 01 15 BD 01 06 B7 01 75 

02D0 20 D3 81 43 26 OB BD 01 15 BD 01 06 B7 01 74 20 

02E0 C4 81 4D 26 1C BD 01 15 BD 01 03 FF 01 77 BD 01 

02F0 15 FE 01 77 BD 01 OF BD 01 06 FE 01 77 A7 00 20 

0300 A4 81 53 26 OB BD 01 15 BD 01 03 FF 01 70 20 95 

0310 81 58 26 91 BD 01 15 BD 01 03 FF 01 72 20 86 FE 

0320 01 6E A6 00 81 6E 27 2C 81 AD 27 28 81 7E 27 20 

0330 81 BD 27 1C 81 8D 27 34 81 39 27 64 81 3B 27 71 

0340 81 3F 27 63 81 3E 27 64 84 FO 81 20 27 11 20 68 

0350 EE 01 20 77 5F A6 01 BB 01 73 F9 01 72 20 63 A6 

0360 00 B7 03 68 B6 01 74 06 20 02 20 4CA6 01 5E 08 
0370 08 FF 01 6E 4D 2D 08 BB 01 6F F9 01 6E 20 43 40 

0380 BO 01 6F F2 01 6E 43 53 8B 01 C9 00 36 FE 01 6E 

0390 09 09 A6 00 81 8D 32 27 29 30 A7 01 E7 00 20 22 

03A0 FE 01 70 EE 01 20 24 EE FF FA 20 1F FE FF F8 20 

03B0 l A FE 0 1 70 EE 06 20 13 B6 01 6D 5F BB 01 6F F9 

03C0 01 6E B7 01 6F F7 01 6E FE 01 6E A6 00 B7 01 77 

03D0 F6 01 6A E7 00 A6 00 11 26 2E A6 01 B7 01 78 F6 

03E0 01 6B E7 01 A6 01 11 26 IF A6 02 B7 01 79 F6 01 

03F0 6C E7 02 A6 02 11 26 10 FE 01 72 F6 01 75 B6 01 

0400 76 36 B6 01 74 06 32 39 7E 01 7A 
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The PAPERBYTETM format for the Grapple and Hemenway “Tracer" program. 

0000000000000000000000000000000000 
00000000001 1 1 1 I I 1 I I 122222222223333 

0123456789012345678901234567890123 

000000000000000000000000000000000 
I 1 1 I 1 1 1 1 1 1 12222222222233333333334 
0 I 34679ACDF0245689BCEF1 24578ABDE0 
071A3E6E6E6E708E6F7F7F7F7F7F7E5D5 



0000000000000000000000000000000000 
00000000001 1 1 1 1 1 1 1 1 122222222223333 
0123456789012345678901234567890123 
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A Note About Bar Codes ... 

Bar codes are the newest form of machine readable data repre¬ 
sentation. They are used in all PAPERBYTE™ software pro¬ 
ducts in BYTE magazine articles and self contained book publi¬ 
cations and combine efficiency of space, low cost, and ease of 
data entry with the need for mass produced machine readable 
representations of software. Bar codes were originaHy used for 
product identification in inventory control and supermarket 
checkout applications. Today, because of their direct binary 
representation of data, they are an ideal computer compatible 
communications medium. In the application of bar codes to soft¬ 
ware distribution (such as PAPERBYTE books and articles), 
the use of a simple but reliable optical scanning wand and an 
appropriate program provides a convenient means for the user 
to acquire software. 

Our intent in making PAPERBYTE software available in 
bar code form is to provide a method of conveying machine read¬ 
able information from documentation to the memories and mass 
storage of a user’s system on a one time basis. We suggest that 
the user of software obtained in this manner should locally record 
the data on the mass storage devices of his system after the data 
has been scanned from the printed page. The PAPERBYTE bar 
code representations provide a standardized means of obtaining 
the data, but they cannot be compared to the convenience 
of local mass storage devices such as floppy disks, digital cassettes 
or audio cassettes. Thus if repeated use of the software obtained 
from bar code is anticipated, we recommend that the user make a 
copy on some form of magnetic medium. 

Bar Code Loader by Ken Budnik, the first in the PAPERBYTE 
series of software books, provides a brief history of bar codes a 
look at the PAPERBYTE bar code format including flowcharts', a 
general bar code loader algorithm and well documented programs 
with complete implementation and checkout procedures for 
6800, 6502 and 8080/Z-80 based systems. 


Bar Codes Provided by: 

Walter Banks 

Computer Communications Network Group 
University of Waterloo 
Waterloo, Ontario, Canada 
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This publication includes 

• "Jack And The Machine Debug" 

• Tracer Program Notes 

• Complete Assembly and Source Listing 

• Complete Object Code Listing 

• Machine Readable Object Code 
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